/*
  ______                              _
 / _____)             _              | |
( (____  _____ ____ _| |_ _____  ____| |__
 \____ \| ___ |    (_   _) ___ |/ ___)  _ \
 _____) ) ____| | | || |_| ____( (___| | | |
(______/|_____)_|_|_| \__)_____)\____)_| |_|
    (C)2017 Semtech

Description: Generic SX126x driver implementation

License: Revised BSD License, see LICENSE.TXT file include in the project

Authors: Miguel Luis, Gregory Cristian
*/
/**
  ******************************************************************************
  *  
  *          Portions COPYRIGHT 2019 STMicroelectronics                       
  *
  * @file    radio_driver.h
  * @author  MCD Application Team
  * @brief   Header for driver radio interface
  ******************************************************************************
 */

/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef __RADIO_DRIVER_H__
#define __RADIO_DRIVER_H__

/* Includes ------------------------------------------------------------------*/

#include <stdint.h>
#include <stdbool.h>

/*==========================================================================*/
/** @addtogroup BSP
  * @{
  */

/** @addtogroup STM32WLXX_NUCLEO STM32WLXX-NUCLEO
  * @{
  */

/** @defgroup STM32WLXX_NUCLEO_RADIO_LOW_LEVEL RADIO LOW LEVEL
  * @{
  */

/** @defgroup STM32WLXX_NUCLEO_RADIO_LOW_LEVEL_Exported_Types RADIO LOW LEVEL Exported Types
  * @{
  */

typedef enum 
{
  RADIO_SWITCH_OFF    = 0,
  RADIO_SWITCH_RX     = 1,
  RADIO_SWITCH_RFO_LP = 2,
  RADIO_SWITCH_RFO_HP = 3,
}BSP_RADIO_Switch_TypeDef;

/**
  * @}
  */ 

/** @defgroup STM32WLXX_NUCLEO_RADIO_LOW_LEVEL_Exported_Constants RADIO LOW LEVEL Exported Constants
  * @{
  */

/** @defgroup STM32WLXX_NUCLEO_RADIO_LOW_LEVEL_RADIOCONFIG RADIO LOW LEVEL RADIO CONFIG Constants
  * @{
  */ 

#define RADIO_CONF_RFO_LP_HP  0
#define RADIO_CONF_RFO_LP     1
#define RADIO_CONF_RFO_HP     2


/* Common Error codes */
#define BSP_ERROR_NONE                         0
#define BSP_ERROR_NO_INIT                     -1
#define BSP_ERROR_WRONG_PARAM                 -2
#define BSP_ERROR_BUSY                        -3
#define BSP_ERROR_PERIPH_FAILURE              -4
#define BSP_ERROR_COMPONENT_FAILURE           -5
#define BSP_ERROR_UNKNOWN_FAILURE             -6
#define BSP_ERROR_UNKNOWN_COMPONENT           -7
#define BSP_ERROR_BUS_FAILURE                 -8
#define BSP_ERROR_CLOCK_FAILURE               -9
#define BSP_ERROR_MSP_FAILURE                 -10
#define BSP_ERROR_FEATURE_NOT_SUPPORTED       -11
/**
  * @}
  */ 

/** @defgroup STM32WLXX_NUCLEO_RADIO_LOW_LEVEL_RFSWITCH RADIO LOW LEVEL RF SWITCH Constants
  * @{
  */ 
  
#define RF_SW_CTRL3_PIN                          GPIO_PIN_3
#define RF_SW_CTRL3_GPIO_PORT                    GPIOC
#define RF_SW_CTRL3_GPIO_CLK_ENABLE()            __HAL_RCC_GPIOC_CLK_ENABLE()
#define RF_SW_CTRL3_GPIO_CLK_DISABLE()           __HAL_RCC_GPIOC_CLK_DISABLE()

#define RF_SW_CTRL1_PIN                          GPIO_PIN_4
#define RF_SW_CTRL1_GPIO_PORT                    GPIOC
#define RF_SW_CTRL1_GPIO_CLK_ENABLE()            __HAL_RCC_GPIOC_CLK_ENABLE()
#define RF_SW_RX_GPIO_CLK_DISABLE()              __HAL_RCC_GPIOC_CLK_DISABLE()

#define RF_SW_CTRL2_PIN                          GPIO_PIN_5
#define RF_SW_CTRL2_GPIO_PORT                    GPIOC
#define RF_SW_CTRL2_GPIO_CLK_ENABLE()            __HAL_RCC_GPIOC_CLK_ENABLE()
#define RF_SW_CTRL2_GPIO_CLK_DISABLE()           __HAL_RCC_GPIOC_CLK_DISABLE()

#define RF_TCXO_VCC_PIN                          GPIO_PIN_0
#define RF_TCXO_VCC_GPIO_PORT                    GPIOB
#define RF_TCXO_VCC_CLK_ENABLE()                 __HAL_RCC_GPIOB_CLK_ENABLE()
#define RF_TCXO_VCC_CLK_DISABLE()                __HAL_RCC_GPIOB_CLK_DISABLE()

/** @defgroup STM32WLXX_NUCLEO_CONFIG_Exported_Constants Exported Constants
  * @{
  */
/* COM usage define */
#define USE_BSP_COM_FEATURE                 0U

/* COM log define */
#define USE_COM_LOG                         0U

/* IRQ priorities */
#define BSP_BUTTON_SWx_IT_PRIORITY         15U

/* Radio maximum wakeup time (in ms) */
#define RF_WAKEUP_TIME                     10U

/* Indicates whether or not TCXO is supported by the board
 * 0: TCXO not supported
 * 1: TCXO supported
 */
#define IS_TCXO_SUPPORTED                   1U

/* Indicates whether or not DCDC is supported by the board
 * 0: DCDC not supported
 * 1: DCDC supported
 */
#define IS_DCDC_SUPPORTED                   1U

/*================================================================================*/

/* Exported constants --------------------------------------------------------*/
#define RFO_LP                                      1
#define RFO_HP                                      2
 
/*!
 * Generic SUBGRF_ error code
 */
#define SUBGRF_OK 0
#define SUBGRF_ERROR -1
    
/*!
 * Radio complete Wake-up Time with margin for temperature compensation
 */
#define RADIO_WAKEUP_TIME                           3 // [ms]

/*!
 * @brief Compensation delay for SetAutoTx/Rx functions in 15.625 microseconds
 */
#define AUTO_RX_TX_OFFSET                           2

/*!
 * @brief LFSR initial value to compute IBM type CRC
 */
#define CRC_IBM_SEED                                0xFFFF

/*!
 * @brief LFSR initial value to compute CCIT type CRC
 */
#define CRC_CCITT_SEED                              0x1D0F

/*!
 * @brief Polynomial used to compute IBM CRC
 */
#define CRC_POLYNOMIAL_IBM                          0x8005

/*!
 * @brief Polynomial used to compute CCIT CRC
 */
#define CRC_POLYNOMIAL_CCITT                        0x1021

/*!
 * @brief The address of the register holding the first byte defining the CRC seed
 *
 */
#define REG_LR_CRCSEEDBASEADDR                      0x06BC

/*!
 * @brief The address of the register holding the first byte defining the CRC polynomial
 */
#define REG_LR_CRCPOLYBASEADDR                      0x06BE

/*!
 * @brief The address of the register holding the first byte defining the whitening seed
 */
#define REG_LR_WHITSEEDBASEADDR_MSB                 0x06B8
#define REG_LR_WHITSEEDBASEADDR_LSB                 0x06B9

/*!
 * @brief The address of the register holding the packet configuration
 */
#define REG_LR_PACKETPARAMS                         0x0704

/*!
 * @brief The address of the register holding the payload size
 */
#define REG_LR_PAYLOADLENGTH                        0x0702

/*!
 * @brief The addresses of the registers holding SyncWords values
 */
#define REG_LR_SYNCWORDBASEADDRESS                  0x06C0

/*!
 * @brief The addresses of the register holding LoRa Modem SyncWord value
 */
#define REG_LR_SYNCWORD                             0x0740

/*!
 * Syncword for Private LoRa networks
 */
#define LORA_MAC_PRIVATE_SYNCWORD                   0x1424

/*!
 * Syncword for Public LoRa networks
 */
#define LORA_MAC_PUBLIC_SYNCWORD                    0x3444

/*!
 * The address of the register giving a 4 bytes random number
 */
#define RANDOM_NUMBER_GENERATORBASEADDR             0x0819

/*!
 * The address of the register holding RX Gain value (0x94: power saving, 0x96: rx boosted)
 */
#define REG_RX_GAIN                                 0x08AC
 
/*!
 * The address of the register holding Bit Sync configuration
 */
#define REG_BIT_SYNC                                0x06AC

/*!
 * Change the value on the device internal trimming capacitor
 */
#define REG_XTA_TRIM                                0x0911

/*!
 * Set the current max value in the over current protection
 */
#define REG_OCP                                     0x08E7

/* Exported types ------------------------------------------------------------*/

/*!
 * @brief Structure describing the radio status
 */
typedef union RadioStatus_u
{
    uint8_t Value;
    struct
    {   //bit order is lsb -> msb
        uint8_t Reserved  : 1;  //!< Reserved
        uint8_t CmdStatus : 3;  //!< Command status
        uint8_t ChipMode  : 3;  //!< Chip mode
        uint8_t CpuBusy   : 1;  //!< Flag for CPU radio busy
    }Fields;
}RadioStatus_t;

/*!
 * @brief Structure describing the error codes for callback functions
 */
typedef enum
{
    IRQ_HEADER_ERROR_CODE                   = 0x01,
    IRQ_SYNCWORD_ERROR_CODE                 = 0x02,
    IRQ_CRC_ERROR_CODE                      = 0x04,
}IrqErrorCode_t;

enum IrqPblSyncHeaderCode_t
{
    IRQ_PBL_DETECT_CODE                     = 0x01,
    IRQ_SYNCWORD_VALID_CODE                 = 0x02,
    IRQ_HEADER_VALID_CODE                   = 0x04,
};



/*!
 * @brief Declares the oscillator in use while in standby mode
 *
 * Using the STDBY_RC standby mode allow to reduce the energy consumption
 * STDBY_XOSC should be used for time critical applications
 */
typedef enum
{
    STDBY_RC                                = 0x00,
    STDBY_XOSC                              = 0x01,
}RadioStandbyModes_t;

/*!
 * @brief Declares the power regulation used to power the device
 *
 * This command allows the user to specify if DC-DC or LDO is used for power regulation.
 * Using only LDO implies that the Rx or Tx current is doubled
 */
typedef enum
{
    USE_LDO                                 = 0x00, // default
    USE_DCDC                                = 0x01,
}RadioRegulatorMode_t;

/*!
 * @brief Represents the possible packet type (i.e. modem) used
 */
typedef enum
{
    PACKET_TYPE_GFSK                        = 0x00,
    PACKET_TYPE_LORA                        = 0x01,
    PACKET_TYPE_BPSK                        = 0x02,
    PACKET_TYPE_GMSK                        = 0x03,
    PACKET_TYPE_NONE                        = 0x0F,
}RadioPacketTypes_t;

/*!
 * @brief Represents the ramping time for power amplifier
 */
typedef enum
{
    RADIO_RAMP_10_US                        = 0x00,
    RADIO_RAMP_20_US                        = 0x01,
    RADIO_RAMP_40_US                        = 0x02,
    RADIO_RAMP_80_US                        = 0x03,
    RADIO_RAMP_200_US                       = 0x04,
    RADIO_RAMP_800_US                       = 0x05,
    RADIO_RAMP_1700_US                      = 0x06,
    RADIO_RAMP_3400_US                      = 0x07,
}RadioRampTimes_t;

/*!
 * @brief Represents the number of symbols to be used for channel activity detection operation
 */
typedef enum
{
    LORA_CAD_01_SYMBOL                      = 0x00,
    LORA_CAD_02_SYMBOL                      = 0x01,
    LORA_CAD_04_SYMBOL                      = 0x02,
    LORA_CAD_08_SYMBOL                      = 0x03,
    LORA_CAD_16_SYMBOL                      = 0x04,
}RadioLoRaCadSymbols_t;

/*!
 * @brief Represents the Channel Activity Detection actions after the CAD operation is finished
 */
typedef enum
{
    LORA_CAD_ONLY                           = 0x00,
    LORA_CAD_RX                             = 0x01,
    LORA_CAD_LBT                            = 0x10,
}RadioCadExitModes_t;

/*!
 * @brief Represents the modulation shaping parameter
 */
typedef enum
{
    MOD_SHAPING_OFF                         = 0x00,
    MOD_SHAPING_G_BT_03                     = 0x08,
    MOD_SHAPING_G_BT_05                     = 0x09,
    MOD_SHAPING_G_BT_07                     = 0x0A,
    MOD_SHAPING_G_BT_1                      = 0x0B,
    MOD_SHAPING_DBPSK                       = 0x16,
}RadioModShapings_t;

/*!
 * @brief Represents the modulation shaping parameter
 */
typedef enum
{
    RX_BW_4800                              = 0x1F,
    RX_BW_5800                              = 0x17,
    RX_BW_7300                              = 0x0F,
    RX_BW_9700                              = 0x1E,
    RX_BW_11700                             = 0x16,
    RX_BW_14600                             = 0x0E,
    RX_BW_19500                             = 0x1D,
    RX_BW_23400                             = 0x15,
    RX_BW_29300                             = 0x0D,
    RX_BW_39000                             = 0x1C,
    RX_BW_46900                             = 0x14,
    RX_BW_58600                             = 0x0C,
    RX_BW_78200                             = 0x1B,
    RX_BW_93800                             = 0x13,
    RX_BW_117300                            = 0x0B,
    RX_BW_156200                            = 0x1A,
    RX_BW_187200                            = 0x12,
    RX_BW_234300                            = 0x0A,
    RX_BW_312000                            = 0x19,
    RX_BW_373600                            = 0x11,
    RX_BW_467000                            = 0x09,
}RadioRxBandwidth_t;

/*!
 * @brief Represents the possible spreading factor values in LoRa packet types
 */
typedef enum
{
    LORA_SF5                                = 0x05,
    LORA_SF6                                = 0x06,
    LORA_SF7                                = 0x07,
    LORA_SF8                                = 0x08,
    LORA_SF9                                = 0x09,
    LORA_SF10                               = 0x0A,
    LORA_SF11                               = 0x0B,
    LORA_SF12                               = 0x0C,
}RadioLoRaSpreadingFactors_t;

/*!
 * @brief Represents the bandwidth values for LoRa packet type
 */
typedef enum
{
    LORA_BW_500                             = 6,
    LORA_BW_250                             = 5,
    LORA_BW_125                             = 4,
    LORA_BW_062                             = 3,
    LORA_BW_041                             = 10,
    LORA_BW_031                             = 2,
    LORA_BW_020                             = 9,
    LORA_BW_015                             = 1,
    LORA_BW_010                             = 8,
    LORA_BW_007                             = 0,
}RadioLoRaBandwidths_t;

/*!
 * @brief Represents the coding rate values for LoRa packet type
 */
typedef enum
{
    LORA_CR_4_5                             = 0x01,
    LORA_CR_4_6                             = 0x02,
    LORA_CR_4_7                             = 0x03,
    LORA_CR_4_8                             = 0x04,
}RadioLoRaCodingRates_t;

/*!
 * @brief Represents the preamble length used to detect the packet on Rx side
 */
typedef enum
{
    RADIO_PREAMBLE_DETECTOR_OFF             = 0x00,         //!< Preamble detection length off
    RADIO_PREAMBLE_DETECTOR_08_BITS         = 0x04,         //!< Preamble detection length 8 bits
    RADIO_PREAMBLE_DETECTOR_16_BITS         = 0x05,         //!< Preamble detection length 16 bits
    RADIO_PREAMBLE_DETECTOR_24_BITS         = 0x06,         //!< Preamble detection length 24 bits
    RADIO_PREAMBLE_DETECTOR_32_BITS         = 0x07,         //!< Preamble detection length 32 bit
}RadioPreambleDetection_t;

/*!
 * @brief Represents the possible combinations of SyncWord correlators activated
 */
typedef enum
{
    RADIO_ADDRESSCOMP_FILT_OFF              = 0x00,         //!< No correlator turned on, i.e. do not search for SyncWord
    RADIO_ADDRESSCOMP_FILT_NODE             = 0x01,
    RADIO_ADDRESSCOMP_FILT_NODE_BROAD       = 0x02,
}RadioAddressComp_t;

/*!
 *  @brief Radio packet length mode
 */
typedef enum
{
    RADIO_PACKET_FIXED_LENGTH               = 0x00,         //!< The packet is known on both sides, no header included in the packet
    RADIO_PACKET_VARIABLE_LENGTH            = 0x01,         //!< The packet is on variable size, header included
}RadioPacketLengthModes_t;

/*!
 * @brief Represents the CRC length
 */
typedef enum
{
    RADIO_CRC_OFF                           = 0x01,         //!< No CRC in use
    RADIO_CRC_1_BYTES                       = 0x00,
    RADIO_CRC_2_BYTES                       = 0x02,
    RADIO_CRC_1_BYTES_INV                   = 0x04,
    RADIO_CRC_2_BYTES_INV                   = 0x06,
    RADIO_CRC_2_BYTES_IBM                   = 0xF1,
    RADIO_CRC_2_BYTES_CCIT                  = 0xF2,
}RadioCrcTypes_t;

/*!
 * @brief Radio whitening mode activated or deactivated
 */
typedef enum
{
    RADIO_DC_FREE_OFF                       = 0x00,
    RADIO_DC_FREEWHITENING                  = 0x01,
}RadioDcFree_t;

/*!
 * @brief Holds the lengths mode of a LoRa packet type
 */
typedef enum
{
    LORA_PACKET_VARIABLE_LENGTH             = 0x00,         //!< The packet is on variable size, header included
    LORA_PACKET_FIXED_LENGTH                = 0x01,         //!< The packet is known on both sides, no header included in the packet
    LORA_PACKET_EXPLICIT                    = LORA_PACKET_VARIABLE_LENGTH,
    LORA_PACKET_IMPLICIT                    = LORA_PACKET_FIXED_LENGTH,
}RadioLoRaPacketLengthsMode_t;

/*!
 * @brief Represents the CRC mode for LoRa packet type
 */
typedef enum
{
    LORA_CRC_ON                             = 0x01,         //!< CRC activated
    LORA_CRC_OFF                            = 0x00,         //!< CRC not used
}RadioLoRaCrcModes_t;

/*!
 * @brief Represents the IQ mode for LoRa packet type
 */
typedef enum
{
    LORA_IQ_NORMAL                          = 0x00,
    LORA_IQ_INVERTED                        = 0x01,
}RadioLoRaIQModes_t;

/*!
 * @brief Represents the volatge used to control the TCXO on/off from DIO3
 */
typedef enum
{
    TCXO_CTRL_1_6V                          = 0x00,
    TCXO_CTRL_1_7V                          = 0x01,
    TCXO_CTRL_1_8V                          = 0x02,
    TCXO_CTRL_2_2V                          = 0x03,
    TCXO_CTRL_2_4V                          = 0x04,
    TCXO_CTRL_2_7V                          = 0x05,
    TCXO_CTRL_3_0V                          = 0x06,
    TCXO_CTRL_3_3V                          = 0x07,
}RadioTcxoCtrlVoltage_t;

/*!
 * @brief Represents the interruption masks available for the radio
 *
 * @remark Note that not all these interruptions are available for all packet types
 */
typedef enum
{
    IRQ_RADIO_NONE                          = 0x0000,
    IRQ_TX_DONE                             = 0x0001,
    IRQ_RX_DONE                             = 0x0002,
    IRQ_PREAMBLE_DETECTED                   = 0x0004,
    IRQ_SYNCWORD_VALID                      = 0x0008,
    IRQ_HEADER_VALID                        = 0x0010,
    IRQ_HEADER_ERROR                        = 0x0020,
    IRQ_CRC_ERROR                           = 0x0040,
    IRQ_CAD_DONE                            = 0x0080,
    IRQ_CAD_ACTIVITY_DETECTED               = 0x0100,
    IRQ_RX_TX_TIMEOUT                       = 0x0200,
    IRQ_RADIO_ALL                           = 0xFFFF,
}RadioIrqMasks_t;



/*!
 * @brief The type describing the modulation parameters for every packet types
 */
typedef struct
{
    RadioPacketTypes_t                   PacketType;        //!< Packet to which the modulation parameters are referring to.
    struct
    {
        struct
        {
            uint32_t                     BitRate;
            uint32_t                     Fdev;
            RadioModShapings_t           ModulationShaping;
            uint8_t                      Bandwidth;
        }Gfsk;
        struct
        {
            uint32_t                     BitRate;
            RadioModShapings_t           ModulationShaping;
        }Bpsk;
        struct
        {
            RadioLoRaSpreadingFactors_t  SpreadingFactor;   //!< Spreading Factor for the LoRa modulation
            RadioLoRaBandwidths_t        Bandwidth;         //!< Bandwidth for the LoRa modulation
            RadioLoRaCodingRates_t       CodingRate;        //!< Coding rate for the LoRa modulation
            uint8_t                      LowDatarateOptimize; //!< Indicates if the modem uses the low datarate optimization
        }LoRa;
    }Params;                                                //!< Holds the modulation parameters structure
}ModulationParams_t;

/*!
 * @brief The type describing the packet parameters for every packet types
 */
typedef struct
{
    RadioPacketTypes_t                    PacketType;        //!< Packet to which the packet parameters are referring to.
    struct
    {
        /*!
         * @brief Holds the GFSK packet parameters
         */
        struct
        {
            uint16_t                     PreambleLength;    //!< The preamble Tx length for GFSK packet type in bit
            RadioPreambleDetection_t     PreambleMinDetect; //!< The preamble Rx length minimal for GFSK packet type
            uint8_t                      SyncWordLength;    //!< The synchronization word length for GFSK packet type
            RadioAddressComp_t           AddrComp;          //!< Activated SyncWord correlators
            RadioPacketLengthModes_t     HeaderType;        //!< If the header is explicit, it will be transmitted in the GFSK packet. If the header is implicit, it will not be transmitted
            uint8_t                      PayloadLength;     //!< Size of the payload in the GFSK packet
            RadioCrcTypes_t              CrcLength;         //!< Size of the CRC block in the GFSK packet
            RadioDcFree_t                DcFree;
        }Gfsk;
                /*!
         * @brief Holds the BPSK packet parameters
         */
        struct
        {
            uint8_t                      PayloadLength;     //!< Size of the payload in the BPSK packet
        }Bpsk;
        /*!
         * @brief Holds the LoRa packet parameters
         */
        struct
        {
            uint16_t                     PreambleLength;    //!< The preamble length is the number of LoRa symbols in the preamble
            RadioLoRaPacketLengthsMode_t HeaderType;        //!< If the header is explicit, it will be transmitted in the LoRa packet. If the header is implicit, it will not be transmitted
            uint8_t                      PayloadLength;     //!< Size of the payload in the LoRa packet
            RadioLoRaCrcModes_t          CrcMode;           //!< Size of CRC block in LoRa packet
            RadioLoRaIQModes_t           InvertIQ;          //!< Allows to swap IQ for LoRa packet
        }LoRa;
    }Params;                                                //!< Holds the packet parameters structure
}PacketParams_t;

/*!
 * @brief Represents the packet status for every packet type
 */
typedef struct
{
    RadioPacketTypes_t                    packetType;      //!< Packet to which the packet status are referring to.
    struct
    {
        struct
        {
            uint8_t RxStatus;
            int8_t RssiAvg;                                //!< The averaged RSSI
            int8_t RssiSync;                               //!< The RSSI measured on last packet
            uint32_t FreqError;
        }Gfsk;
        struct
        {
            int8_t RssiPkt;                                //!< The RSSI of the last packet
            int8_t SnrPkt;                                 //!< The SNR of the last packet
            int8_t SignalRssiPkt;
            uint32_t FreqError;
        }LoRa;
    }Params;
}PacketStatus_t;

/*!
 * @brief Represents the Rx internal counters values when GFSK or LoRa packet type is used
 */
typedef struct
{
    RadioPacketTypes_t                    packetType;       //!< Packet to which the packet status are referring to.
    uint16_t PacketReceived;
    uint16_t CrcOk;
    uint16_t LengthError;
}RxCounter_t;

/*!
 * @brief Represents a calibration configuration
 */
typedef union
{
    struct
    {
        uint8_t RC64KEnable    : 1;                             //!< Calibrate RC64K clock
        uint8_t RC13MEnable    : 1;                             //!< Calibrate RC13M clock
        uint8_t PLLEnable      : 1;                             //!< Calibrate PLL
        uint8_t ADCPulseEnable : 1;                             //!< Calibrate ADC Pulse
        uint8_t ADCBulkNEnable : 1;                             //!< Calibrate ADC bulkN
        uint8_t ADCBulkPEnable : 1;                             //!< Calibrate ADC bulkP
        uint8_t ImgEnable      : 1;
        uint8_t                : 1;
    }Fields;
    uint8_t Value;
}CalibrationParams_t;

/*!
 * @brief Represents a sleep mode configuration
 */
typedef union
{
    struct
    {
        uint8_t WakeUpRTC               : 1;                    //!< Get out of sleep mode if wakeup signal received from RTC
        uint8_t Reset                   : 1;
        uint8_t WarmStart               : 1;
        uint8_t Reserved                : 5;
    }Fields;
    uint8_t Value;
}SleepParams_t;

/*!
 * @brief Represents the possible radio system error states
 */
typedef union
{
    struct
    {
        uint8_t Rc64kCalib              : 1;                    //!< RC 64kHz oscillator calibration failed
        uint8_t Rc13mCalib              : 1;                    //!< RC 13MHz oscillator calibration failed
        uint8_t PllCalib                : 1;                    //!< PLL calibration failed
        uint8_t AdcCalib                : 1;                    //!< ADC calibration failed
        uint8_t ImgCalib                : 1;                    //!< Image calibration failed
        uint8_t XoscStart               : 1;                    //!< XOSC oscillator failed to start
        uint8_t PllLock                 : 1;                    //!< PLL lock failed
        uint8_t BuckStart               : 1;                    //!< Buck converter failed to start
        uint8_t PaRamp                  : 1;                    //!< PA ramp failed
        uint8_t                         : 7;                    //!< Reserved
    }Fields;
    uint16_t Value;
}RadioError_t;

/*!
 * @brief Represents the operating mode the radio is actually running
 */
typedef enum
{
    MODE_SLEEP                              = 0x00,         //! The radio is in sleep mode
    MODE_STDBY_RC,                                          //! The radio is in standby mode with RC oscillator
    MODE_STDBY_XOSC,                                        //! The radio is in standby mode with XOSC oscillator
    MODE_FS,                                                //! The radio is in frequency synthesis mode
    MODE_TX,                                                //! The radio is in transmit mode
    MODE_RX,                                                //! The radio is in receive mode
    MODE_RX_DC,                                             //! The radio is in receive duty cycle mode
    MODE_CAD                                                //! The radio is in channel activity detection mode
}RadioOperatingModes_t;

/*!
 * Radio driver internal state machine states definition
 */
typedef enum
{
    RFSWITCH_RX = 0,   //!< The radio is in RX
    RFSWITCH_TX = 1    //!< The radio is in TX
}RFState_t;

/*!
 * SUBG_RF definitions
 */

/*!
 * @brief Provides the frequency of the chip running on the radio and the frequency step
 *
 * @remark These defines are used for computing the frequency divider to set the RF frequency
 */
#define XTAL_FREQ                                   ( double )32000000
//#define FREQ_DIV                                    ( double )pow( 2.0, 25.0 )
//#define FREQ_STEP                                   ( double )( XTAL_FREQ / FREQ_DIV )
#define FREQ_STEP_14                                15625   /* (XTAL_FREQ / FREQ_DIV) >> 14 */

/* channel = Freq / FREQ_STEP */
#define SX_FREQ_TO_CHANNEL( channel, freq )                                                                       \
    do                                                                                                            \
    {                                                                                                             \
        uint32_t initialFreqInt, initialFreqFrac;                                                                 \
        initialFreqInt = freq / FREQ_STEP_14;                                                                      \
        initialFreqFrac = freq - ( initialFreqInt * FREQ_STEP_14 );                                                \
        channel = ( initialFreqInt << 14 ) + ( ( ( initialFreqFrac << 14 ) + ( FREQ_STEP_14 / 2 ) ) / FREQ_STEP_14 ); \
    }while( 0 )



#define RX_BUFFER_SIZE                              256

/* External variables --------------------------------------------------------*/
/* Exported macros -----------------------------------------------------------*/
/* Exported functions ------------------------------------------------------- */

/*!
 * ============================================================================
 * Public functions prototypes
 * ============================================================================
 */

/*
 * SUBG_RF DIO IRQ callback functions prototype
 */

/*!
 * @brief  DIO IRQ callback : must be provided by SUBG_RF clients
 * @param  none
 * @retval none
 */
void RadioOnDioIrq( RadioIrqMasks_t radioIrq );

/*!
 * @brief Initialises the bus for SUBG_RF driver communication
 * @param none
 * @retval error code 0: OK, negatif: fail
 */
int32_t SUBGRF_Init( void (*RadioOnDioIrqCb) ( RadioIrqMasks_t radioIrq ) );

 /*!
 * @brief  Gets the current Operation Mode of the Radio
 * @param  none
 * @retval RadioOperatingModes_t last operating mode
 */
RadioOperatingModes_t SUBGRF_GetOperatingMode( void );



/*!
 * @brief Saves the payload to be send in the radio buffer
 * @param [in]  payload       A pointer to the payload
 * @param [in]  size          The size of the payload
 * @retval none
 */
void SUBGRF_SetPayload( uint8_t *payload, uint8_t size );

/*!
 * @brief Reads the payload received. If the received payload is longer
 * than maxSize, then the method returns 1 and do not set size and payload.
 * @param [out] payload       A pointer to a buffer into which the payload will be copied
 * @param [out] size          A pointer to the size of the payload received
 * @param [in]  maxSize       The maximal size allowed to copy into the buffer
 * @retval none
 */
uint8_t SUBGRF_GetPayload( uint8_t *payload, uint8_t *size, uint8_t maxSize );

/*!
 * @brief Sends a payload
 * @param [in]  payload       A pointer to the payload to send
 * @param [in]  size          The size of the payload to send
 * @param [in]  timeout       The timeout for Tx operation
 * @retval none
 */
void SUBGRF_SendPayload( uint8_t *payload, uint8_t size, uint32_t timeout );
/*!
 * @brief Sets RF switch for TX & RX
 * @param [in]  power       Low Power or High Power board
 * @param [in]  rxtx        RX/TX mode
 * @retval none
 */
void SUBGRF_SetSwitch (uint8_t power, RFState_t rxtx);

/*!
 * @brief Sets the Sync Word given by index used in GFSK
 * @param [in]  syncWord      SyncWord bytes ( 8 bytes )
 * @retval      status        [0: OK, 1: NOK]
 */
uint8_t SUBGRF_SetSyncWord( uint8_t *syncWord );

/*!
 * @brief Sets the Initial value for the LFSR used for the CRC calculation
 * @param [in]  seed          Initial LFSR value ( 2 bytes )
 * @retval none
 */
void SUBGRF_SetCrcSeed( uint16_t seed );

/*!
 * @brief Sets the seed used for the CRC calculation
 * @param [in]  seed          The seed value
 * @retval none
 */
void SUBGRF_SetCrcPolynomial( uint16_t polynomial );

/*!
 * @brief Sets the Initial value of the LFSR used for the whitening in GFSK protocols
 * @param [in]  seed          Initial LFSR value
 * @retval none
 */
void SUBGRF_SetWhiteningSeed( uint16_t seed );

/*!
 * @brief Gets a 32 bits random value generated by the radio
 * @param  none
 * @remark The radio must be in reception mode before executing this function
 * @retval randomValue    32 bits random value
 */
uint32_t SUBGRF_GetRandom( void );

/*!
 * @brief Sets the radio in sleep mode
 * @param [in]  sleepConfig   The sleep configuration describing data
 *                            retention and RTC wake-up
 * @retval none
 */
void SUBGRF_SetSleep( SleepParams_t sleepConfig );

/*!
 * @brief Sets the radio in configuration mode
 * @param [in]  mode          The standby mode to put the radio into
 * @retval none
 */
void SUBGRF_SetStandby( RadioStandbyModes_t mode );

/*!
 * @brief  Sets the radio in FS mode
 * @param  none
 * @retval none
 */
void SUBGRF_SetFs( void );

/*!
 * @brief  Sets the radio in transmission mode
 * @param  [in]  timeout : Structure describing the transmission timeout value
 * @retval none
 */
void SUBGRF_SetTx( uint32_t timeout );

/*!
 * @brief Sets the radio in reception mode
 * @param [in]  timeout : Structure describing the reception timeout value
 * @retval none
 */
void SUBGRF_SetRx( uint32_t timeout );

/*!
 * @brief Sets the radio in reception mode with Boosted LNA gain
 * @param [in]  timeout       Structure describing the reception timeout value
 * @retval none
 */
void SUBGRF_SetRxBoosted( uint32_t timeout );

/*!
 * @brief Sets the Rx duty cycle management parameters
 * @param [in]  rxTime        Structure describing reception timeout value
 * @param [in]  sleepTime     Structure describing sleep timeout value
 * @retval none
 */
void SUBGRF_SetRxDutyCycle( uint32_t rxTime, uint32_t sleepTime );

/*!
 * @brief Sets the radio in CAD mode
 * @param  none
 * @retval none
 */
void SUBGRF_SetCad( void );

/*!
 * @brief Sets the radio in continuous wave transmission mode
 * @param  none
 * @retval none
 */
void SUBGRF_SetTxContinuousWave( void );

/*!
 * @brief  Sets the radio in continuous preamble transmission mode
 * @param  none
 * @retval none
 */
void SUBGRF_SetTxInfinitePreamble( void );

/*!
 * @brief Decide which interrupt will stop the internal radio rx timer.
 * @param [in]  enable          [0: Timer stop after header/syncword detection
 *                               1: Timer stop after preamble detection]
 * @retval none
 */
void SUBGRF_SetStopRxTimerOnPreambleDetect( bool enable );

/*!
 * @brief Set the number of symbol the radio will wait to validate a reception
 * @param [in]  SymbNum          number of LoRa symbols
 * @retval none
 */
void SUBGRF_SetLoRaSymbNumTimeout( uint8_t SymbNum );

/*!
 * @brief Sets the power regulators operating mode
 * @param [in]  void
 * @retval none
 */
void SUBGRF_SetRegulatorMode( void  );

/*!
 * @brief Calibrates the given radio block
 * @param [in]  calibParam    The description of blocks to be calibrated
 * @retval none
 */
void SUBGRF_Calibrate( CalibrationParams_t calibParam );

/*!
 * @brief Calibrates the Image rejection depending of the frequency
 * @param [in]  freq    The operating frequency
 * @retval none
 */
void SUBGRF_CalibrateImage( uint32_t freq );

/*!
 * @brief Activate the extention of the timeout when long preamble is used
 * @param [in]  enable      The radio will extend the timeout to cope with long preamble
 * @retval none
 */
void SUBGRF_SetLongPreamble( uint8_t enable );

/*!
 * @brief Sets the transmission parameters
 * @param [in]  paDutyCycle     Duty Cycle for the PA
 * @param [in]  hpMax          0 for RFO_LP, 7 for RFO_HP
 * @param [in]  deviceSel       1 for RFO_LP, 0 for RFO_HP
 * @param [in]  paLut           0 for 14dBm LUT, 1 for 22dBm LUT
 * @retval none
 */
void SUBGRF_SetPaConfig( uint8_t paDutyCycle, uint8_t hpMax, uint8_t deviceSel, uint8_t paLut );

/*!
 * @brief Defines into which mode the chip goes after a TX / RX done
 * @param [in]  fallbackMode    The mode in which the radio goes
 * @retval none
 */
void SUBGRF_SetRxTxFallbackMode( uint8_t fallbackMode );



/*!
 * @brief   Sets the IRQ mask and DIO masks
 * @param [in]  irqMask       General IRQ mask
 * @param [in]  dio1Mask      DIO1 mask
 * @param [in]  dio2Mask      DIO2 mask
 * @param [in]  dio3Mask      DIO3 mask
 * @retval none
 */
void SUBGRF_SetDioIrqParams( uint16_t irqMask, uint16_t dio1Mask, uint16_t dio2Mask, uint16_t dio3Mask );

/*!
 * @brief Returns the current IRQ status
 * @retval      irqStatus     IRQ status
 * @retval none
 */
uint16_t SUBGRF_GetIrqStatus( void );


/*!
 * @brief Indicates if the Radio main clock is supplied from a tcxo
 * @param [in] tcxoVoltage     voltage used to control the TCXO
 * @param [in] timeout         time given to the TCXO to go to 32MHz
 * @retval none
 */
void SUBGRF_SetTcxoMode( RadioTcxoCtrlVoltage_t tcxoVoltage, uint32_t timeout );

/*!
 * @brief Sets the RF frequency
 * @param [in]  frequency     RF frequency [Hz]
 * @retval none
 */
void SUBGRF_SetRfFrequency( uint32_t frequency );

/*!
 * @brief Sets the radio for the given protocol
 * @param [in]  packetType    [PACKET_TYPE_GFSK, PACKET_TYPE_LORA]
 * @remark This method has to be called before SetRfFrequency,
 *         SetModulationParams and SetPacketParams
 * @retval none
 */
void SUBGRF_SetPacketType( RadioPacketTypes_t packetType );

/*!
 * @brief   Gets the current radio protocol
 * @param   none
 * @retval  packetType    [PACKET_TYPE_GFSK, PACKET_TYPE_LORA]
 */
RadioPacketTypes_t SUBGRF_GetPacketType( void );

/*!
 * @brief Sets the transmission parameters
 *
 * @param [in]  paSelect      RegPaConfig PaSelect value (RFO_LP, RFO_HP, etc)
 * @param [in]  power         RF output power [-18..13] dBm
 * @param [in]  rampTime      Transmission ramp up time
 * @retval none
 */
void SUBGRF_SetTxParams( uint8_t paSelect, int8_t power, RadioRampTimes_t rampTime );



uint8_t SUBGRF_SetTxPower(  int8_t power, RadioRampTimes_t rampTime );
/*!
 * @brief Set the modulation parameters
 * @param [in]  modParams : structure describing the modulation parameters
 * @retval none
 */
void SUBGRF_SetModulationParams( ModulationParams_t *modParams );

/*!
 * @brief Sets the packet parameters
 * @param [in]  packetParams: structure describing the packet parameters
 * @retval none
 */
void SUBGRF_SetPacketParams( PacketParams_t *packetParams );

/*!
 * @brief Sets the Channel Activity Detection (CAD) parameters
 *
 * @param [in]  cadSymbolNum   The number of symbol to use for CAD operations
 *                             [LORA_CAD_01_SYMBOL, LORA_CAD_02_SYMBOL,
 *                              LORA_CAD_04_SYMBOL, LORA_CAD_08_SYMBOL,
 *                              LORA_CAD_16_SYMBOL]
 * @param [in]  cadDetPeak     Limite for detection of SNR peak used in the CAD
 * @param [in]  cadDetMin      Set the minimum symbol recognition for CAD
 * @param [in]  cadExitMode    Operation to be done at the end of CAD action
 *                             [LORA_CAD_ONLY, LORA_CAD_RX, LORA_CAD_LBT]
 * @param [in]  cadTimeout     Defines the timeout value to abort the CAD activity
 * @retval none
 */
void SUBGRF_SetCadParams( RadioLoRaCadSymbols_t cadSymbolNum, uint8_t cadDetPeak, uint8_t cadDetMin, RadioCadExitModes_t cadExitMode, uint32_t cadTimeout );

/*!
 * @brief  Sets the data buffer base address for transmission and reception
 * @param  [in]  txBaseAddress Transmission base address
 * @param  [in]  rxBaseAddress Reception base address
 * @retval none
 */
void SUBGRF_SetBufferBaseAddress( uint8_t txBaseAddress, uint8_t rxBaseAddress );

/*!
 * @brief  Gets the current radio status
 * @param  none
 * @retval Radio status
 */
RadioStatus_t SUBGRF_GetStatus( void );

/*!
 * @brief  Returns the instantaneous RSSI value for the last packet received
 * @param  none
 * @retval rssiInst      Instantaneous RSSI
 */
int8_t SUBGRF_GetRssiInst( void );

/*!
 * @brief Gets the last received packet buffer status
 * @param [out] payloadLength Last received packet payload length
 * @param [out] rxStartBuffer Last received packet buffer address pointer
 * @retval none
 */
void SUBGRF_GetRxBufferStatus( uint8_t *payloadLength, uint8_t *rxStartBuffer );

/*!
 * @brief  Gets the last received packet payload length
 * @param  [out] pktStatus     A structure of packet status
 * @retval none
 */
void SUBGRF_GetPacketStatus( PacketStatus_t *pktStatus );

/*!
 * @brief   Returns the possible system erros
 * @param   none
 * @retval  sysErrors Value representing the possible sys failures
 */
RadioError_t SUBGRF_GetDeviceErrors( void );

/*!
 * @brief Clears the IRQs
 * @param [in]  irq           IRQ(s) to be cleared
 * @retval  none
 */
void SUBGRF_ClearIrqStatus( uint16_t irq );

/*!
 * @brief   Service to get the radio wake-up time.
 * @param   none
 * @retval  Value of the radio wake-up time.
 */
uint32_t SUBGRF_GetRadioWakeUpTime( void );

/*!
 * @brief Get Error
 * @param   none
 * @retval  sysErrors Value representing the possible sys failures
 */
RadioError_t SUBGRF_GetErrors( void );

/*!
 * @brief Write radio register
 * @param   adress of the register
 * @param   data to write
 * @retval  none
 */
void SUBGRF_WriteRegister( uint16_t addr, uint8_t data );

/*!
 * @brief Read radio register
 * @param   adress of the register
 * @retval  Data read
 */
uint8_t SUBGRF_ReadRegister( uint16_t addr );

/*!
 * @brief Write several consecutive radio register
 * @param   adress of the 1st register to write
 * @param   array of datas to write
 * @param   amount of datas to write
 * @retval  none
 */
void SUBGRF_WriteRegisters( uint16_t addr, uint8_t *buffer, uint8_t size );

/*!
 * @brief Read several consecutive radio register
 * @param   adress of the 1st register to read
 * @param   array of datas to read
 * @param   amount of datas to read
 * @retval  none
 */
void SUBGRF_ReadRegisters( uint16_t addr, uint8_t *buffer, uint8_t size );
#endif // __RADIO_DRIVER_H__

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

